home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / fileq102.zip / FILE-EQ.DOC < prev    next >
Text File  |  1993-03-10  |  24KB  |  596 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                           F I L E   E Q U A L I Z E R
  12.                          =============================
  13.  
  14.                                     Wildcat!
  15.  
  16.                           A File Database Door Utility
  17.                        ==================================
  18.  
  19.                               From Member's of the
  20.                         Wildcat! 3.x Alpha and Beta Team
  21.                       ====================================
  22.  
  23.                       Supports Single & Multi-Node Systems
  24.  
  25.                          Release Version 1.02 - 3/10/93
  26.                         (C)opyright 1993 PC Connections
  27.  
  28.  
  29.                                    Mike Ortiz
  30.                                5237 SW 31st Terr
  31.                                 Topeka, KS 66614
  32.  
  33.  
  34.                                  Dale Fedorchik
  35.                              2446 Forest Drive 104
  36.                               Woodridge, IL 60517
  37.  
  38.  
  39.  
  40.                           The Software Connection BBS
  41.                      (913) 271-2070  USR DS 14400 (Locked)
  42.                         271-2071  USR DS 16800 (Locked)
  43.                         271-2072  USR DS 14400 (Locked)
  44.                         271-2073  USR DS 14400 (Locked)
  45.                         271-2074  USR HST 14.4 (Locked)
  46.                         271-2076  USR DS 14400 (Locked)
  47.  
  48.                             1200 / 16.8K   24 Hours
  49.                                Fido Net  1:281/2
  50.  
  51.                           Magic Freq FileName: FILE_EQ
  52.                              For The Latest Version
  53.                     (913) 271-2079 Voice (6PM-10PM Central)
  54.  
  55.  
  56.                               The Cat's Castle BBS
  57.                                  (708) 910-4425
  58.                               9600 V.32   24 Hours
  59.                               Fido Net  1:115/910
  60.  
  61.  
  62.  
  63.                                Support Of Product
  64.                             ========================
  65.  
  66.      I just want to ensure those that decide to register this product
  67.      that Dale and I will do our very best to help you with any problems
  68.      you might encounter.  We will also keep File Equalizer updated to the
  69.      current Wildcat release.  I want to make it clear that File Equalizer
  70.      is supported by Dale and I, and if you have a problem you should make
  71.      an effort to contact one of us, after all who knows the program
  72.      better than the two of us.
  73.  
  74.  
  75.  
  76.                                     Warranty
  77.                                  ==============
  78.  
  79.      This product is provided "As Is" without warranty of any kind. The
  80.      entire risk as to the results and performance of the program is
  81.      assumed by you. Furthermore, I the author do not warrant,
  82.      guarantee, or make any representations regarding the use of, or the
  83.      results of the use of the program, and you rely on the program and
  84.      results solely at your own risk.  I the author cannot accept
  85.      responsibility for system damage, loss of profit, or any other
  86.      special, incidental, or consequential damages resulting from the
  87.      use or inability to use this product.
  88.  
  89.  
  90.  
  91.  
  92.                                    Copyright
  93.                                 ===============
  94.  
  95.      File Equalizer is distributed under the SHAREWARE concept. You may use
  96.      File Equalizer with the demo key for a period of thirty days.
  97.      After which you must either register your copy or discontinue usage.
  98.  
  99.  
  100.                                   Distribution
  101.                                ==================
  102.  
  103.      You are free, in fact encouraged, to distribute The File Equalizer with
  104.      other sysop's provided that all files contained in the original archive
  105.      are distributed in their original unmodified state.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                             What File Equalizer Does
  124.                           ============================
  125.  
  126.      The File Equalizer is a door program that allows you to use a file
  127.      list to create a database of files that you can make available to
  128.      your users. It's like a "All Files" bbs within your bbs. To give you
  129.      an example. Let's say you have access to a bbs that has 10,000 +
  130.      files online. You can take their file list and make a EQ file
  131.      database with it. File Equalizer also has a user database which adds
  132.      the user to the database when they enter the door. They are given a
  133.      starting balance of money which you decide in the configuration
  134.      program. They may send you more money which you add to their bank
  135.      account. You determine how much each kilobyte will cost the user in
  136.      the configuration program. Then the user(s) can access the door
  137.      and select files from the list that they want. File Equalizer will
  138.      subtract the amount needed for the file(s) they selected, from their
  139.      EQ user database. As long as they have money in the bank to cover the
  140.      cost of the file(s) they can keep making requests. By setting up a
  141.      event you can have File Equalizer call the bbs which has the files and
  142.      download them via a script file. At present, only Qmodem and PcPlus have
  143.      been tested although I assume any communication program that has script
  144.      capabilities could work. After downloading the requested file(s) from
  145.      the bbs, File Equalizer then adds the file(s) to the desired Wildcat
  146.      file database. It will optionally password protect the file with the
  147.      user name who requested it. If for some reason the file doesn't get
  148.      downloaded from the bbs (file no longer in their database) then File
  149.      Equalizer will re-credit the user(s) account with the amount originally
  150.      subtracted for the file requested.
  151.  
  152.      Think of it....this is a great way for your user(s) to have access to
  153.      lots of files without taking up valuable disk space from your board.
  154.      Let's say you set up your system to charge .0025 cent for every 1
  155.      kilobyte and the user has 10.00 in the bank. They select a 100 kilobyte
  156.      file, File Equalizer will subtract 25 cents from their account and
  157.      add that to the list of requested file(s). In a nightly event you check
  158.      to see if any file(s) were requested, if so you have the script call
  159.      the selected bbs and download the file(s). The file(s) get added to
  160.      the Wildcat database. You can also choose to password protect the file
  161.      with the user(s)s name who requested it, if you want to make sure only
  162.      they have access to the file, or you can leave all file(s) available to
  163.      all File Equalizer User(s).
  164.      They sign on the next day and download the file. They are happy because
  165.      they got the file they wanted and you as a sysop are offering them such
  166.      a large selection of files to choose from. You are happy because you
  167.      figure in a profit to off set the cost when you configure how much to
  168.      charge per kilobyte.
  169.      I think it's a better idea then charging a one time fee to join your
  170.      board. Then when they run out of money they are much more likely
  171.      to send you more money for their account as they are used to having
  172.      access to the new wonderful file selection you have given them. It's a
  173.      nice way to try to secure a constant flow of cash to your operations.
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                           How To SetUp File Equalizer
  183.                          =============================
  184.  
  185.      1. Take the EXE files from the FILEQXXX archive and place them in a
  186.      directory that is in your path statement. ie: C:\WC30
  187.  
  188.  
  189.      2. Make a directory to store the EQ database. You can call it anything
  190.      you wish ... I named mine C:\WC30\EQ
  191.      Put all the other files in the archive into the EQ directory, except
  192.      the files from either the PCPLUSEQ.ZIP or the QMODEMEQ.ZIP. Depending
  193.      on which comm program you are using unzip those files into your comm
  194.      program directory.
  195.  
  196.  
  197.      3. Change to that directory and run the EQEDIT configuration program.
  198.      It will ask the following questions:
  199.  
  200.         1. What is the minimum security menu level to allow to use the
  201.      door ? (This is a number such as 10, 20, etc ).
  202.  
  203.         2. What is the sysop security menu level ? (This is usally the number
  204.      1000 ).
  205.  
  206.         3. What is the full path to the Ascii bulletin ? (This would be the
  207.      full path and file name to the ascii bulletin that you want to use to
  208.      notify user(s) that file(s) selected today will be available tommorrow.
  209.      IE: C:\WC30\BULL\BULL2.BBS ).
  210.  
  211.         4. What is the full path to the Ansi bulletin ? (This is the same as
  212.      above except that it is the ansi version of the bulletin.
  213.      IE: C:\WC30\BULL\BULL2.SCR ).
  214.  
  215.         5. What default amount of money should a user(s) start off their
  216.      account with ? (This would be the amount of money to put in a user(s)
  217.      bank account as the enter the door for the first time.  It must follow
  218.      the 0.00 format.
  219.      IE: 0.25 would mean to start them off with 25 cents ).
  220.  
  221.         6. What amount of user(s) credit should be issued ? (This is a future
  222.      feature that also must follow the 0.00 format. For now you can just
  223.      enter 0.00 there ).
  224.  
  225.         7. How much should File Equalizer charge for each single kilobyte
  226.      of file requested ? (This is the charge for each 1K of file. I set mine
  227.      to one quarter of a cent, so that a 100K file will charge the user(s)
  228.      25 cents to request for download. This amount is really a matter of the
  229.      speed of the modem you are going to use,  phone charges, and ofcourse
  230.      how much you wish to make off the door ). One quarter of a cent would
  231.      be 0.0025, a half cent would be 0.0050, a cent would be 0.001, and so
  232.      on.
  233.  
  234.         8. What is the path to the EQ user database ? (This is the full
  235.      path name minus the file ending to the File Equalizer user database.
  236.      IE: C:\WC30\EQ\USERDAT ).
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.         9. What is the path to the EQ file database ? (This is the same as
  247.       above except that it to the File Equalizer file database.
  248.       IE: C:\WC30\EQ\FILEDAT ).
  249.  
  250.        10. What is the path to your bad keys list ? (This is a path to your
  251.       Wildcat bad keys list file. {BADKEYS.LST}
  252.       IE: C:\WC30 ).
  253.  
  254.        11. What is the path to your temporary directory ? (When The File
  255.        Equalizer makes a downloadable file list it needs a temporary
  256.        directory to do it in. MAKE SURE YOU CREATE THIS DIRECTORY!
  257.        IE: D:\TEMP ).
  258.  
  259.        12. Should RtsCts be used (Y/N) ?  (If you are using a high speed
  260.        modem you should set this to yes otherwise you can set it to no.
  261.  
  262.  
  263.      Save this file as EQ.CFG file in the EQ directory.
  264.  
  265.  
  266.      4. The following files will also be placed in the EQ database
  267.      directory ( IE: C:\WC30\EQ ).
  268.  
  269.      OPENING.SCR and OPENING.BBS, after you edit them to your suiting.
  270.      EQ.KEY, Your Demo or Registered Key File.
  271.      EQLIST.BAT, after you edit it to fit your system setup.
  272.  
  273.  
  274.  
  275.      5. You will need to examine the file list you want to add before
  276.      running EQFILE.EXE. EQFILE will need to know the following information
  277.      for its command line parameters.
  278.         [1]: Full path to the file list. {ie: C:\TEXT\FILELIST.TXT}
  279.         [2]: File area number to begin adding at. {ie: 1}
  280.         [3]: Line to start reading file name at. {ie: 1}
  281.         [4]: Line to start reading file size at. {ie: 13}
  282.         [5]: Line to start reading file date at. {ie: 25}
  283.         [6]: Line to start reading file description at. {ie: 36}
  284.         [7]: How far down from top of list to first file listing. {ie: 14}
  285.         [8]: Use two line descriptions Y/N ? {ie: Y}
  286.         [9]: Add keywords Y/N ? {ie: Y}
  287.  
  288.      Keep in mind that using keywords will extend the time needed to make
  289.      the database. This could be several hours depending on the size of
  290.      the filelist you wish to use.
  291.      When you know how you will answer the above questions then run the
  292.      EQFILE.EXE and have the file list that you want to use available.
  293.      Please see the sample below:
  294.  
  295.      EQFILE reconizes either a * or ▓ as the 3rd as the file area separator.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307. *******************************************************************************
  308.  
  309.                             The Software Connection                            
  310.  
  311.                 File List Generated by WildList 1.0 on 02/19/93
  312.  
  313.                      Registered to Mike Ortiz   # 88-208                       
  314.  
  315.  
  316.  
  317. ===============================================================================
  318. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Adlib, SoundBlaster, CakeWalk ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  319. ===============================================================================
  320.                 [LIST STARTS HERE AT LINE 14 DOWN FROM TOP]
  321. 104SONGS.ZIP  205,332   03/26/91 | Collection of 104 songs for Adlib/SB    
  322. DwnLds: 31    LastDL:   09/13/92 | 
  323. 1           13          25         36
  324. [FILENAME  ][FILESIZE]  [DATE]     [DESCRIPTION]
  325. 107_WANS.ZIP   13,927   07/14/92 | Soundblaster file. No description.      
  326. DwnLds: 4     LastDL:   07/21/92 | [USES 2 LINE DESCRIPTIONS]
  327.  
  328. ===============================================================================
  329. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ Ansi Screens and Menus ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  330. ===============================================================================
  331.                         [THIS WOULD START FILE AREA 2]
  332. #1-0TRDR.ZIP   56,800   08/17/92 | ░▓Painting program for Wildcat! 3.50▓░  
  333. DwnLds: 41    LastDL:   10/18/92 | 
  334.  
  335. #4TESSLA.ZIP   30,558   09/06/92 | ansi screens from The Tessla Coil!      
  336. DwnLds: 8     LastDL:   10/12/92 | 
  337.  
  338. *******************************************************************************
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.      6. You will also need to make up a file named after the name you
  348.      chose for your EQ file database plus the suffix (.DIR). This should
  349.      be an ascii text file that shows the file area(s) available and the
  350.      area number assigned to it, pretty self explainatory. This should
  351.      be placed in your EQ directory.
  352.      See example below:
  353.  
  354.  
  355. [1]   Adlib,SoundBlaster & Cakewalk        [21] BBS Programs
  356. [2]   Ansi Screens & Menus                 [22] Screens & Printers
  357. [3]   Card & Board Games                   [23] Programming Section
  358. [4]   Database & Word Processors           [24] Desk Top Publishing
  359. [5]   Business & Money Programs            [25] Window Related
  360. [6]   Dos & General Utilities              [26] MacIntosh 1
  361. [7]   Home & Personal Use                  [27] MacIntosh 2
  362. [8]   Misc 1                               [28] Misc 3
  363. [9]   Menu,Shells & Archives               [29] Wildcat 3.xx
  364. [10]  Entertainment & Games                [30] Virus Protection
  365. [11]  Misc 2                               [31] Cooking & Recipes
  366. [12]  Action Packed Games                  [32] Ham & Radio Utilities
  367. [13]  Text Files                           
  368. [14]  Disk Utilities
  369. [15]  New Uploads 1
  370. [16]  Education & Learning
  371. [17]  Modem Utilities
  372. [18]  Software Unprotects,Solves & Docs
  373. [19]  Network,Desqview & Novell
  374. [20]  New Uploads 2
  375.  
  376.  
  377.      7. Once the EQ file database is completed you can create the EQ user
  378.      database by adding yourself first. Just run EQ.EXE, it will inform
  379.      you that it could not read your name in the door.sys and ask you for
  380.      your name. Once you have the main menu you can advance to the sysop
  381.      menu. There, select change a user status. You can now add money to your
  382.      bank account. Normally a user would enter EQ as a door and automatically
  383.      be added to the database. Of course they will only have the default
  384.      amount of money that you specified in the EQ configuration program at
  385.      that point. As the sysop you can scan the user database and change any
  386.      user(s) statistics. This will allow you to add money into their account
  387.      as they send it to you.
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.      8. Next you need to set up the batch files to run File Equalizer, this
  400.      can be a bit tricky so I'll try to show you examples as we go. The 1st
  401.      batch file to make is the one for the door itself.
  402.      The example of the DOOR#.BAT follows:
  403.  
  404.      @echo off
  405.      cd\wc30\eq
  406.      eq c:\wc30\wcwork\node%wcnodeid%\door.sys
  407.      if exist d:\temp\*.zip erase d:\temp\*.zip
  408.  
  409.      Next comes the batch file that you activate as a nightly event. This
  410.      batch file makes the script that calls the host bbs and downloads the
  411.      files requested that day, if there were any requested by user(s). It
  412.      also runs EQ2WC.EXE which adds the file to the selected Wildcat file
  413.      area with or without the password option. REMEMBER if you use the
  414.      password option to allow user(s) to view passworded files in your WC
  415.      makewild settings. An example of this batch file is shown below...
  416.      please see comments by batch lines. It is also assumed that you are
  417.      using Qmodem as your comm program of choice.
  418.      The example of the EQEVENT.BAT is as follows:
  419.  
  420.      @echo off
  421.      if not exist c:\wc30\eq\download.dat goto end {see if requests were made}
  422.      if exist c:\wc30\eq\download.dat goto start
  423.      :start
  424.      d:                  {change drive}
  425.      cd\qmodem           {change directory to qmodem}
  426.      makescr mike qmodem {make the script file}
  427.      qmodem /s=mike      {place call using script file}
  428.      c:                  {change drive}
  429.      cd\wc30\eq          {change directory to eq}
  430.      eq2wc 27 c:\eq1 Y   {add files to WC database #, path, and use passwords}
  431.      copy download.dat c:\wc30 {make a backup of download.dat file}
  432.      del download.dat    {delete download.dat file in eq directory}
  433.      goto exit
  434.      :end
  435.      goto exit
  436.      :exit
  437.      cd\wc30
  438.  
  439.      Alot of this may need changed in your situation, but it should give
  440.      you an idea of what to do.
  441.                                                   
  442.  
  443.  
  444.  
  445.  
  446.      8. Lastly is the script file creation. Again...it is assumed that you
  447.      are using Qmodem. I would imagine that other comm programs
  448.      capable of script operation could be used, let us know.
  449.      It is also assumed that you have a basic understanding of script
  450.      file operation, if not you may want to read up on it. We will try
  451.      to give you a working understanding in the example below. See
  452.      comments at side of lines again:
  453.  
  454.      * In the example below please note that MIKE, MIKE1 and MIKE2 must
  455.      be in the Qmodem directory.
  456.  
  457.  
  458.      [The name of this file would be MIKE]
  459.  
  460.      d:\qmodem\mike.scr       {change to qmodem directory name file MIKE.SCR}
  461.      c:\wc30\eq\download.dat  {read the file download.dat}
  462.      MIKE                     {use MIKE as file name with part1 and part2}
  463.  
  464.      [This file is called MIKE1]
  465.  
  466.  
  467.      Graphics ANSI                 {Qmodem script settings}
  468.      TurnOFF  ECHO                            *
  469.      TurnON   8_BIT                           *
  470.      TurnOFF  LINEFEED                        *
  471.      TurnOFF  XON/XOFF                        *
  472.      TurnOFF  NOISE                           *
  473.      TurnOFF  MUSIC                           *
  474.      TurnON   SCROLL                          *
  475.      TurnOFF  PRINT                           *
  476.      TurnOFF  SPLIT                           *
  477.      TurnON   STATUSLN                        *
  478.      TurnOFF  DOORWAY                         *
  479.  
  480.      TimeOut  30     ; Set Waitfor for 30 seconds    {sign on script}
  481.      Dial     "6"                                           *
  482.      LoadKEY  ANSI.KEY                                      *
  483.      Graphics ANSI                                          *
  484.                                                             *
  485.      Waitfor  "What is your first name?"                    *
  486.      Delay    100                                           *
  487.      Send     "*dale fedorchik TEST^M"                      *
  488.                                                             *
  489.      Waitfor  "m The Loop In Chicago? [Y]^[[D^[[D"          *
  490.      Delay    100                                           *
  491.      Send     "yfd" {answers yes and then goes to file menu and downloads}
  492.  
  493.  
  494.      MAKESCR.EXE inserts the download.dat data here so that the script
  495.      will request to download those files from the bbs.
  496.  
  497.      *Note* MAKESCR.EXE has a second command line parameter it
  498.      is either QMODEM or PCPLUS. If you are using QMODEM then put QMODEM
  499.      as the second paramater. If you are using PCPLUS then put PCPLUS
  500.      as the second parameter.
  501.  
  502.  
  503.  
  504.  
  505.  
  506.      [This file is called MIKE2]
  507.  
  508.    
  509.      Send     "^M"
  510.      Delay    100
  511.  
  512.      Waitfor  "download is completed? [N]^[[D^[[D"  {signs off when done}
  513.      Delay    100
  514.      Send     "y"
  515.  
  516.      Delay    100
  517.      Send     "Z"   {selects Zmodem as protocol}
  518.  
  519.      Download Z C:\EQ1\  {puts downloaded files in C:\EQ1 directory}
  520.      hangup              {hangs up phone}
  521.      clrscr              {clears screen}
  522.      System Y            {goes back to batch file which called it}
  523.  
  524.  
  525.      Again...script files are the hardest part of it all. You will need to
  526.      understand how they work to make File Equalizer work right. The above
  527.      is an example using Qmodem and signing on to a Wildcat bbs. We only
  528.      hope it helps give you an idea of how the script operation works. Also
  529.      included in this package is PCPLUSEQ.ZIP which gives examples using
  530.      PCPLUS as your comm program. (Thanks to Robert Chapman)
  531.  
  532.  
  533.      The File Equalizer will create a EQ.LOG file which details what occurs
  534.      while EQ is running. It will also create an EQ.ERR file for any errors
  535.      that occur while EQ is running. EQCFG.ERR details any errors occuring
  536.      while using EQEDIT.EXE
  537.  
  538.  
  539.               File Equalizer LICENSING AND DISTRIBUTION AGREEMENT
  540.             =======================================================
  541.  
  542.      You may not incorporate parts of File Equalizer into other programs
  543.      with out written permission from Mike Ortiz or Dale Fedorchik.
  544.      Permission may or may not be granted based upon a determination of
  545.      your intended use.
  546.  
  547.      You must keep this License Agreement intact and give any other
  548.      recipients of the File Equalizer program a copy of this License
  549.      Agreement along with the program.
  550.  
  551.  
  552.                                Closing Comments
  553.                               ==================
  554.  
  555.       Mike and I really feel that this is a great product that can help
  556.       almost any Wildcat sysop. We hope you register this and all our
  557.       products. We will try to assist you in any problems you might
  558.       encounter in the operation of The File Equalizer or any of our
  559.       products. We will be offering The File Equalizer to other bbs
  560.       types PCBOARD, etc. in the future. Please keep us posted with your
  561.       ideas!
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.                                  Special Bonus
  571.                               ===================
  572.  
  573.      As an added benefit I am giving free access to my BBS to any
  574.      registered user(s) of File Equalizer.  The Software Connection can
  575.      be used for Support on File Equalizer, Wildcat 3.0, and any Utilities
  576.      for 3.0,  I have 6 lines Locked at 19.2 See the Begining of this
  577.      document to see which line will fit you best. The Support System has
  578.      roughly 6.5 gigs Of Space, over 45,000 files, Lots Of Wildcat Utilities
  579.      and Doors.  So With your registration you not only get a great program
  580.      but great place for support, questions, and plenty of files to post
  581.      on your own BBS or use for your File Equalizer database.  All have been
  582.      scanned With CatScan (The Best file Scanner for Wildcat 3.x).
  583.  
  584.  
  585.  
  586.                                  Mike Ortiz...
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.